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1 Introduction to Part 2 


In Part 1 of this lab, you created a human workflow in Process Designer that automates the key steps of 
our Order Management scenario. You may recall that the structure of the solution includes an “order 
fulfillment” phase that is totally automated, and that should be implemented by an Advanced Integration 
Service (AIS) as shown below: 



Part 2 of the lab walks you through the steps that are necessary to implement the advanced integration 
service. 

Notice that the figure shows that the order needs to be recorded in the manufacturing DB, and that an 
assembly process in manufacturing needs to be kicked off at the same time. 

We are going to be creating a BPEL process in Integration Designer, and we are going to take 
advantage of the JDBC adapter to interact with the database. 

The interaction with the assembly line occurs via web services. 


Before you proceed, make sure that you read and perform the relevant 
set-up instructions that can be found in the Appendix! 
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2 Creating the Advanced Integration Project 


Let’s open the IBM Integration Designer and create a new workspace to host our integration project. 
_1. Start the IBM Integration Designer: 





Design Data 
Stop Sample Server 


IBM Integration Designer 7.5 



2 . When prompted to select a workspace, create a new one: 



3. The first time a workspace is used, you are asked to provide connection information to the 
Process Center (if you need to connect immediately). Connect to the local Process Center 
(http://localhost:9080/ProcessCenter) and specify admin/admin for the credentials: 
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Process Center Login x 


Log in to start working with Process Center or cancel to switch to the Business 
Integration perspective. 

Process Center URI: 

Example: http://server:port/ProoessCenter 

http://localhost: 9080/P rocessCenter 

User Name: 
admin 


Password: 


Login Cancel 


4. Close the “Getting Started with IBM Process Center 7.5” page: 


Getting Started with IBM Process Center 7.5 





"I 


lr>a S 


.5. You should now see the Process Center view from within Integration Designer. It looks exactly 
like the view you may be accustomed to as a user of Process Designer. Notice - however - that 
by the Process Applications you have an option to “Open in workspace” rather than “Open in the 
designer”. Click Open in workspace for the Order Management application: 


S»ia* I aeceiltf JMKtd am I • I|«M" | 


6. Each advanced integration project includes two dependent projects - one for the implementation 
and one for the common items (business objects, interfaces) called a “library”. Accept the 
defaults and click OK. 


J Cpfci n Mdixipace- 


Order Management (OMP) 

Lh! upaawd on ! ?H 1 fay adm I- 
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7. Close the Getting Started with IBM Integration Designer 7.5 view: 


© Getting Started - IBM Integrationpesgner 


S3 


Getting Started with IBM Integration Designer 7.5 

1 ~ 1 ' ~~ 1 


.8. You are now placed into the Business Integration perspective. On the Navigator view, expand 
the Order_Management_Library project. Expand the Data and Interfaces folders. Notice the 
presence of the Order business objects (which was defined in Part 1 by the Process Designer), 
and of the OrderFulfillment interface (which was implicitly defined in Process Designer too, 
when you created the Advanced Integration Services): 


\3 -\z} Order_Management_Library 
Dependencies 
V 1 Integration Logic 


EK ' Data 

; 1 . Q Order 

&•(© Interfaces 


OrderFulfillment 


9. Double click Order to open the Business Object editor: 
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▼ Business object / 


Configuration 


Name 

Order 

Re; 

Namespace 

http://OMP 

Re; 


▼ Definition 


r n 

Q Order 

^ <Click to filter.,,> 

[e] orderNumber int 

[el widgetColor string 

[el widgetSize int 

[e] widgetWeight double 
l _i 

_10. The editor shows the Business Object definition that corresponds to the data type that was 
created in Process Designer. Close the Business Object editor. 

_11. Double click the OrderFulfillment interface in the navigator view to open the Interface Editor: 

| Binding Style | document literal wrapped_ Change binding style to document literal non-wrapped More. ■■ 

^Operations Jjj? & B | P | 


Operations and their parameters 




Name 

Type 

▼ invoke 






order 

Order 


| [0 Outputs 

serviceResponse 

string 



12. The editor shows the interface that Advanced Integration Service exposes to its consumers. 
Notice the input and output parameters, which correspond to the definitions made in Process 
Designer. 

13. Close the Interface Editor. 

14. Back on the navigator pane, expand Advanced Integration Services. Notice how there is an 
Order Fulfillment item with an indication that it is an unimplemented service. This way, the 
user of Integration Designer knows that there is work to be done to complete the integration 
logic: 


Advanced Integration Services 


; . Order Fulfillment (unimplemented) 

rH • -L'l r^. 
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3 Implementing the Integration Service 

Let’s now complete the implementation of the Advanced Integration Service. 
_ 1 . Right-click Order Fulfillment (unimplemented) and click Implement: 

□•••(££ Advanced Integration Services 


Order Fulfillment (unimplemented) 


Processes 

j.(J^ 1 Dependent Toolkits 

2. Out of the four options that are available as an implementation style, select Microflow: 






.3. Click Finish. Since we selected microflow, the BPEL editor opens up, showing a skeleton of a 
BPEL process: 



A. You are going to complete the implementation later on. Close the BPEL editor now. 

.5. Back on the navigator pane, expand the Order_Management_lmplementation folder, and 
double-click Assembly Diagram. The Assembly Diagram is the canvas where you can wire 
together the components of your integration solution. 


El ^ Order_Management_Implementation 

El '^j Assembly Diagram 

. (T 0 
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.6. When you implement an Advanced Integration Service, Integration Designer automatically puts 
the implementation (OrderFulfillment_Process) and an Export component (OrderFulfillment) 
on the canvas. The Export component allows consumers to invoke the 
OrderFulfillment Process. 




^ OrderFulfillment 




OrderFulfillment Process 


7. Let’s take a look at the OrderFulfillment export. It is an SCA Export. Select it, and switch to the 
Properties tab in the lower pane, and then click Binding. Make sure that the checkbox named 
Make operations visibile to IBM Process Designer is checked: 

l Order_Management_Implementation - Assembly Diagram S3 


Palette 




& Favorites 


Components 
^ Untyped Comp.,. 


(3 Outbound Imp... 


(2i> Inbound Exports 


Outbound Ada... 


Inbound Adapt... T 




O 


OrderFulfillment 




/ 


tivities 


a Task Flows '--Q Build Activities [ [_1 Properties £2 \ Problems 


^ Export: QrtJerFulfillnient (No Binding) 


Description 


Details 


Binding 


All Qualifiers 


0 Make operations visible to IBM Process Designer 


This checkbox allows BPMN processes to call this specific export component. If your assembly diagram 
had multiple SCA exports, you could selectively exposed those that are visible to business users by 
using this checkbox. 


8. Let’s now add a JDBC outbound adapter to the diagram. In our scenario, we wish to interact with 
the Manufacturing database. To achieve this, we will utilize the JDBC Adapter provided with the 
product. We add an outbound JDBC Adapter which will begin the database adapter creation 
wizard. Before launching the wizard, be sure you know the connection parameters to the 
database as well as a suitable userid/password that will be used for connection authentication 
and authorizations (we’ll provide the defaults in the instructions). 

_a. In the Assembly Diagram editor, right-click anywhere on the canvas. Then click 

Add...>Outbound Adapters>JDBC. 
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(TUndo 

■^Redo 

Revert 


0 ,Add Note 
Hide Notes 


^ Cut 
>,Copy 
Paste 


^Delete 

Select All 


Merge Components 


C+JZoom In 
G^Zoom Out 


-/■ ? "^Automatic Layout 

Layout Contents 


Test Module 
Show Display Name 


Show In 


] '- r ' Untyped Component 
ft|) Human Task 


Show Transaction Highlighting 
Remove Transaction Highlighting 


Ctrl+= 

Ctrl+- 


Lr 1 Java 

^Mediation Flow 
Process 
E[ ; Rule Group 
Testate Machine 
[^Import 
43 Export 
y References 

Interface Map (Deprecated) 
•^Selector 

Outbound Imports 
Inbound Exports 


Outbound Adapters 


I .^Enterprise Content Manager 
E^CICS 
r^i E-mail 
□f Flat File 
ft^FTP 
[njllMS 
iSeries 


j^JD EdwardS EnterpriseOne 
Lotus Domino 
^PeopleSoft 
1 Oracle E-Business Suite 
[srF'SAP 
Q '^‘‘Siebel 
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fc>. The first time you use an adapter within a workspace, you’ll be requested to set it up. 
Accept the only option offered by the wizard and click Next: 



c. Adapters code is packaged in Resource Archive (RAR) files. These files (similar to JAR 
files) need to be present in your workspace as a Connector Project. Leave the defaults 
and click Next: 


sF New Externa I Service 


Import a RAR File 

Import a resource adapter archive (RAR) from the file system to create a connector 
project for the adapter. 



Archive file: C: \IBM\IntegrationDesigner\v7. SV^esourceAdapters 

\3 DBC_7.5.0.0 \CWYBCJDBC. ra r 

Connector project: * | CWYBCJDBC 

Target runtime enviroment: |lBM Process Server v7.5 



< Back 


Next > 


Finish 


Cancel 
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d. Since the JDBC adapter needs to use the JDBC drivers, you need to specify where they 
are located. On your system, they should be in the <BPM Install 
Directory>\jdbcdrivers\DB2 folder. Click Add... and select the two files indicated by the 
screen shot below: 
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e. Specify the DB connection properties. First of all, select the appropriate version of DB2 
(V9.1). Specify MANUFAC for the DB name, and bpmadmin/bpmadminl for the 
credentials: 
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f. Click Next. You should not see a dialog that asks you to discover objects in the back-end 
system. Click Run Query to discover tables and views to use through the adapter: 



g. The query will bring back a number of schemas. Expand the BPMADMIN schema where 
you created the MAN U FAC table. Select the MANUFAC table and click on the right 
arrow icon to move it to the Selected objects list: 
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h. Click Next. Now you should be prompted with a list of operations that can be performed 
on the table. Since all we want to do is to insert a row when an order comes in, you need 
to remove all the operations, except for Create. Select all the operations below Create 
and click Remove: 
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Now that the list only contains Create, uncheck the Generate business graph for each 
business object checkbox: 


Specify Composite IToperties 

Specify pt op^SiK that Apply to (J stated 


5 


1 


Operaliens for selectbusiness objects 



Add..- | 


Cu£l6m Bust^sS FAufts 

Pattern for the Cudon Busness Fajts: 


[ Pattern string 


Custom Fau t Hamt 


Add... 


Edfc, 


p-mcvE 


d_I jJ 

Cffeabe and configure user-defined wrapper objects 
Wrapper object names; 



Business object rare^ce: * \ bttp:/.-\\wvi .ibn.com, r xmfc r TS,.*prad/websphere ,*]Zca*dbc 

Specify lh«r foder fix ge-rtalrd busress objMts 


IT Generate a business grasm for each business ob;ect 



Advanced >> | 

@ 


l 

< 1 ** | text a ] fjr | Cancel 

* 
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_j. Click Next. You now need to specify some data source properties. Select Using security 

properties from the managed connection factory and specify the credentials 
(bpmadmin/bpmadminl). Specify the data source JNDI name (jdbc/MANUFAC) as 
shown below: 
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.9. Click Next to get to the last step of this wizard. Here you can leave the defaults (notice the name 
of the Import that will be created for you): 



a. Click Finish. You should now see the new JDBCImport component on the Assembly 
Diagram: 


4 


OrderFulfillment 


4 * 


OrderFulfillnnent Process 


0 [(jf JDBCImport ) 


10. Let’s now create an import for our “Factory Floor” back-end, which is accessible through web 
services. The web service application is assumed to be installed on the Process Center. 

_a. Open a browser and test the web service at the URL: 

http://localhost:9080/FactorvFloorWeb/scaAA/orkQrder?wsdl 

_b. You should be prompted with the WSDL. Notice that the URL on the browser has also 

changed to http://localhost:9080/FactoryFloorWeb/scaAA/orkQrderAA/EB- 
INF/wsdl/FactorvFloor WorkOrder.wsdl . Cut and past that URL for later use in the lab. 

_c. Back in the Integration Designer, click File -> Import.... 
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d. Select Business Integration > WSDLs and XSDs: 



e. Click Next. 
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f. A wizard is started asking us where we are to locate the artifacts. The choices are from 
the local file system or by direct retrieval from the service provider itself. We choose the 
direct retrieval option: 



g. Click Next. 
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h. You need to specify the URL for the remote WSDL and XSD. Paste the URL we copied 
from the browser a few moments earlier. Also, check the two checkboxes about creating 
separate files for business objects and port types: 



i. Click Next. 
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_j. You should now see the list of resources that are going to be imported: 



k. Click Finish. We are now ready to create our Web Service Import. 

l. On the Assembly Diagram editor, select Web Service under Outbound Imports in the 
palette on the left. Drag-and-drop that component onto the canvas: 
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m. As the component drops on the canvas, a wizard starts up. The first step requires you to 
select an interface for the web service. Click Browse... and then select FactoryFloor 
from the list: 



n. Click OK and then Next. 
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_o. You now need to specify the web service port. Make sure that Use an existing web 

service port is selected, and click Browse. Select the port that you are prompted with: 


sf* New Web Service Import Service 


Specify Web Sevice Port 

Specify an existing Web service port or generate Web service port and 
implementation, 





t Pi 


'■* Use an existing web service port 
Port: | <no port specified> 

C* Generate a new web service definition and inr- 


\ 


Browse 



WSImportl Service Port 


This will launch J2EE tools to help build and 
This option is only recommended for advar Filter {? = any character. 


n 

any String): 


r Do not specify a web service port at this time p 


Matching service ports: 


ay 





< Back 

i 







fS Task Flows 

Cq Build Activities 

f— 

S F 

^5 Order_Management_Iniplei 



Description 


All Qualifiers 


Name: Order_ 

Display name: 
Description: 


http://FactoryFloor/FactoryFloor - Order. 

il_I ±J 



Cancel 


_p. Click OK and then Next. 
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q. On the subsequent screen, leave the selection of the protocol to the default 
(SOAP1.1/HTTP): 



r. Click Finish. The Assembly Diagram should now be populated with the following objects: 
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s. Let’s connect the OrderFulfillment_Process to the new Import components. Hover with 
the mouse on the process component right end, and drag a wire to the “I” (interface) of 
the JDBCImport component - as shown below: 



t. Click OK on the message that tells you that a reference will automatically be created on 
the process component: 



u. Repeat the wiring steps for the WSImport component: 
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v. Once you are done, the Assembly Diagram should look as follows: 




£ 




[Jf JDBCImport 


OrderFulfillment 


— ^ OrderFulfillment_Process 




*2 WSImportl 


w. Save your work (Ctrl-S). You should see some red “x” decorations on the references. 
This happens because we have added new references to the component, but its 
implementation doesn’t know about them yet. To resolve the discrepancy, right-click the 
process component and click Synchronize Interfaces and References... > to 
implementation: 




from Implementation 


to Implementation 



x. Click OK on the two confirmation messages: 
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_y. Save your work. 

11. Complete the implementation of the BPEL process. 

_a. What we wish to do next is to add in the BPEL activities that we will use. Double-click 

the BPEL process on the Assembly Diagram to open the implementation skeleton. 

_b. Drag three Assign activities and two Invoke activities from the palette. The following 

shows the process with activities inserted into it. 


Order_Management_Implementation ► OrderFulfillment_Process 


^ Invoke 
j Assi| 

^3 Receive 
^ Receive Choio 


& Structures 
fa\ Scope 

[Xj Parallel Activities 
§§ Sequence 
Choice 
While Loop 
tf) Repeat Until Loop 

@ Faults 

Human Workflow 





Lab 1 


Page 33 
























IBM Software 


IBM BPM 7.5 STEW 


_c. Rename the activities (just click on each one of them to enter edit mode for the name 
directly on the diagram): 

o 



~r 

o 


d. Now it is time to start adding details to each of the activities so that at runtime, we 
execute the logic that we wish performed. First we associated the Insert into DB 
Invoke activity with the JDBC Import partner. Select the activity and go to the Properties 
tab. Click the Details sub-tab, and click Browse... for the Partner: 


Jo Task Flows ^5 Build Activities H Properties £3 ft' Problems 


Logs ifi 


Server 


Servers 
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e. Select JDBCImportPartner: 


0 Select a Partner □ 1 B 

Partner Name (? = any character, * = any String); 


New... 


Matches: 

U FactoryFloorPartner 
B JDBCImportPartner 


Interface: 


http://Manufacturing/JDBCImport - JDBCImport 




OK 


Cancel 



f. Click OK. 

g. We now need to define variables for both the input and output parameters of the service 
call. Click on (none) for the input variable, and then select New...: 
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h. Give the variable a name (manufaclnput) and click OK: 



_i. Similarly, for the output variable, choose to create a new one: 

fities | 1 1 Properties £3 \ [~* Problems | lj|g) Server Logs | vfl Servers | Cg Asset Repositories | 


A 'T7 r 


I 


3 DB 


Partner: * O JDBCImportPartner 

Interface: 46 JDBCImport 

Operation: * O createBpmadminManufac [▼ 

0 Use data type variables mapping 


Browse. 



Q Browse... 

^0 Mew... 

manufaclnput: Bpmadminl 



Name 

Type Ny 

Read frc 

C>] Inputs 

createBpmadminManufacInput 

BpmadminManufac 

V many 


Name 

Type 

Sto^Mnl 

[D Outputs 

createBpmadminManufacOutput 

BpmadminManufac 

<> p E 


1 




_j. Call it manufacOutput and click OK: 


New Va ria ble 


Variable Name 



OK 


Cancel 
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k. We have completed the definition of the first invoke activity (there should be no red “x” 
signs): 






1/ □ iL 


Insert into uB 


Prep for Factory Floor 


_I. Repeat the steps for partner association and variable creation (only one) for Invoke 

Factory Floor, as shown below: 



m. Now that we have both invoke activities defined, we need to assign information to their 
input variables. We could have used a single BPEL variable for all the services involved 
(as we did in Parti for the BPMN process). However, in real life this is a very rare 
occurrence. Luckily, IID has a set of great mapping tools to move information around. We 
are going to be using the “Assign” activities here. Click on Prep for DB Insert and go to 
the Properties > Details. 

n. This is where you implement the mapping. You need to move information from the order 
variable (which is the input of the BPEL process) to the manufactlnput variable fields. 
Click on selectFrom and then expand order. Pick the first item (orderNumber). Then 
click selectTo and pick manufaclnput.ordernumber. 
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o. Once you are done with the first line, click Add. Repeat the mapping steps for the 
remaining three fields. At the end, you should have this implementation: 


•fwwws 3 JT Server logs it. Servers ti Asset Hetx»tor« j T 


isert 


Assign From 

c^< | 

Assgi to 

V order ordefNu ffbtr 

** 


# mam/adrtpul ordenximter 

order widgetCotor 

4 


I# manufaclnput ootor 

« order vrtdgetStf* 

A 


V rnsnufsclnput are 


# order widge Weight 


# manufaclrpm 


p. Save your work. 

q. Similarly, click Prep for Factory Floor and perform the mapping as shown below: 


S Assign - Prep for factory floor 


From 


<€> 

AssgnTe 

Add 

# order ordeflMumber 

4 

<> 

^ /.‘orfcRrqurs: orderNurtber 


fle-nove 

m order widoetcotor 

xfr 

'o 

m kReoues? cotor 

4 

UP 

W order AidgetSize 

4 


10 worWlequest size 

4 


V order vvtdgetweitfit 

4 

■=£ 

# woritflequest 

4 1 




r. Save. And finally, click Set Result. Here, when you click selectFrom, pick String and 
then type Order Fulfilled on the text box (no quotes). Map that literal to 
serviceResponse as shown below: 


Assign - Set Result 

Desorption 

Details 

Server 


| Asagn From 


A-:jigr 


Oder Fiifiled 

1- 

# aef^ceResportse 

i 





r 


s. By doing so, the process will return “Order Fulfilled” in the response field. This is a very 
simplistic implementation of the BPEL process. We could instrument it with fault handling, 
compensation, and so on - and provide more meaningful responses - but you get the 
idea. 

t. Save your work. In the Problems view, you should notice this error: 


l|-i UM I 

El © Errors (1 item) 

© The dependent project ’CWYBCJDBC 1 must be associated with one of the toolkit dependencies of 'Order Management', or the process 
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u. This occurs because the Order Management project requires the adapter project, but the 
adapter project is not known by the Process Center. In order to ensure that the adapter 
itself gets published out to the Process Center, we need to associated it to the Process 
Center. Right-click the adapter project (CWYBC_JDBC) and then click Associate with 
the Process Center: 


raTMiittnu»i 

File Edit Naviga 


Show In 


Alt+Shift+W ► 



Associate with Process Center 


Copy Qualified Name 
|j|] Paste 


<all resources: ^ 

Build Path 

B-@G [changed 

Advar 


+ 


.O 

Proce 


Refactor 

Import 

Export 


Ctrl-HZ 

Ctrl -FV 
Delete 

Alt+Shift+T 


0"fj=7 Order 
m A: 

i. e d. 

B (& Ir 
E1"'l Di 


B- 


'i' 


Ir 
Tr 
Order 

>£d, 

0-lD Di 

u 


- 


s 


■ Ir 

e 

a 

d 

d 

• Tr. 


Configure 
JPA Tools 


Properties 


Alt+Enter 


ffl- ■ T W Migrate connector project. 


B NawnwOT 


^Refresh F5 

Close Project 

Close Unrelated Projects 

Add to Asset Repository... 

Validate 


Add SQLJ Support... 


Run As 

► 

Debug As 

► 

Profile As 

► 

Team 

► 

Compare With 

► 

Restore from Local History... 


Java EE 

► 

Services 

► 

Source 

► 


i —i i 
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v. On the subsequent screen, ensure that the CWYBC_JDBC project is selected, and that 
the Order Management process application is the containing application: 



w. Click Finish. You should observe that the adapter project has now moved under Order 
Management Main. 

x. Right-click Order Management Main and select Refresh and Publish to push down all 
we did to the Process Center: 


k : - Business Integration £3 

©I e [&| cc 




B % ~ 


<all resources 

B- “ 

E -Advanced Integration i 


[changed] Order Managem 


^5 Order_Management_Implementation - Assembl 
<] i} Palette 




& Favorites 


New 


° rcJer Fulfillment ^ Focus Business Integration View on Order Management 

W Processes Show References in References View 

!.Dependent Toolkits 

g.g-4 CWYBC JDBC Associate with Process Center 

0 lS Order_Management_In Change Toolkit Dependencies 

+ - 1 Assembly Diagram 

I [JiTr Dependencies Refresh from Process Center^ 

S Integration Logic Replace With ► 


We are now done with all the implementation steps. But before we test and run our solution, we need to 
create a data source. 


12. Create the JDBC Data Source. 
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When we created our JDBC Adapter definition, we said that the database to which we are going to 
connect has a JNDI name of j dbc/MANUFAC. This means that we need to create the corresponding 
definition in the runtime of the Process Server. We perform this in two steps. The first is the creation of 
a J2C security alias that allows us to define a userid/password pair required for a database Data Source 
definition. Once done, we create the Data Source definition itself. 


a. Launch the IBM Admin Console (in a browser, http://localhost:9060/admin) and navigate 
to Security > Global Security and find the J2C authentication data link on the 
right hand side. 


Integrated Solutions Console welcome admin 

Cell=win7-x64Node01Cell r Profile = ProcSrv01 


Global secui 


View: All tasks 

■ Welcome 



Cl os 


El Guided Activities 
El Servers 
El Applications 


El Resources 
El Security 


Business Integration Security- 
Global security 
Security domains 

Administrative Authorization Groups 
SSL certificate and key management 
Security auditing 
Bus security 


El Environment 
El Integration Applications 


El System administration 
El Users and Groups 
El Monitoring and Tuning 
El Troubleshooting 
0 Service integration 


El UDDI 


Global security 

Use this panel to configure administration and the default application security policy. This security configuration applies to the security" policy 
administrative functions and is used as a default security policy for user applications. Security domains can be defined to override and custor 
policies for user applications. 


Security Configuration Wizard | Security Configuration Report | 

Administrative security 

0 Enable administrative security a Administrative user roles 
H Administrative group roles 
Q Administrative authentication 

Application security 

0 Enable application security 

Java Z security 

□ Use Java 2 security to restrict application access to local resources 
0 Warn if applications are granted custom permissions 
Restrict access to resource authentication data 

User account repository 
Current realm definition 

Federated repositories | 

Available realm definitions 


Authentication 

Authentication mechanisms and expiration 

# LTPA 

Kerberos and LTPA 

Kerberos configuration 

SWAM (deprecated): No authenticated communication 
Authentication cache settings 

g Web and SIP security 
g RMI/TIOP security 

2 Java Authentication and Authorization Service 

■ Application logins 

■ System loo ins 

■ J2C authentication data 

i 1 Use realm-qualified user names 



Sect 


•itv domains 
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b. Create a new security alias by clicking the New button. 


Global security 


Global security > JAA5-J2C authentication data 

Specifies a list of user identities and passwords for Java(TM) 2 conne 
0 Prefix new alias names with the node name of the cell [for comp 


Apply 1 


El Preferences 


1 

C e |*0 


Select 

Alias £ 

User ID £ 

You can administer the following resources: 

□ 

BPCDB win7- 

db2admin 

x64NodeO 1 .serverl Auth Alias 


□ 

BPCDB win7- 

db2admin 

x64NodeO 1 .server 1 Auth Alias XAR 



c. In the new alias, we enter a name, userid and password for the alias (use 
bpmadmin/bpadminl and call the alias db2admin): 


Global security 


Global security > JAAS - J2C authentication data > New 
Specifies a list of user identities and passwords for Java(TM] 
General Properties 


+ Alias 



Apply | ok 


Reset 


Cancel 


d. It is now time to define the Data source that represents our database. Again in the WAS 
admin console we navigate to Resources > JDBC > Data sources. There we 
define that we are going to add a new Data source definition at the server level (select 
the entry with serverl from the pull down list, and click New): 
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Integrated Solutions Console welcome admin 


Help I Lot 




View: All tasks 

- 

■ Welcome 



Cell=win7-x64NQdeQlCell, Profile=PrQc5rvQl 

\ m ns _ 



Data sources 

U = e this page to edit the settings of a datasource that is associated with your selected JDBC providei 
application with connections for accessing the database. Learn more about this task in a guided acti\ 
task steps and more general information about the topic. 

H Scope: Cell=wirc7-x64Node01Cell Node=win7-x64Node01, 5erver=serverl 


Scope specifies the level at which the resource definition is visible. For detailed information 
what scope is and how it works r see the scope settings help. 


Node=win7-x64Node01 r Server=serverl | | 



[3 Preferences 


New ^^^te | Test connection Manage state... | 

e e *g * f 

Select 

Name £ 

JNDI name £ 

Scope 0 

Provider £ 

You can administer the following resources: 


□ 

EPEDataSourceD b2 

jdbc/BPEDB 

Node=win7- 

xS4Node0i r Server=serverl 

DE2 Universal JDBC 
Provider £XA) 

DB2 Universal JDBC 
Provider CXA) 

Business Space JD 
Provider 

n 

Business Process 

jdbc/com.ibm.ws.sib 

/win7- 

x64Node01.serverl- 

BPC.win7- 

xS4NodeO 1 Cell. Bus 

Node=vfln7- 

x64Node01 r Server=serverl 

ChoreoGraoher ME 

data source 

□ 

Business Space 

jdbc/mashupDS 

Node=win7- 

x64NodeQlrServer=serverl 

data source 






e. A database Data Source definition wizard is started for us. In the wizard, we enter 
jdbc/MANUFAC as the identity for this definition: 
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f. We select our database provider. We will find that a DB2 driver is already present: 



g. Next we define which database this Data Source associates. We select the manufac 
database at the local machine (localhost). Also, uncheck that checkbox about CPM 
persistence: 
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h. Next we name the security alias that we defined earlier as the identity for a number of the 
internal Data Source operations: 


Create a data source 


Step Is Enter basic 
data source 
information 

Step 2: Select JDBC 
provider 

Step 3: Enter 
database specific 
properties for the 
data source 

Step 4: Setup 
security aliases 

Step 5: Summary 


Setup security aliases 


Select the authentication values for this resource, 


Authentication alias for XA recovery _ 

| BPM75Node01/db2admin 

Component-managed authentication alias 

| BPM75Node01/db2admin 



Mapping-configuration alias 

((none) ^ | 

Container-managed authentication alias 


BPM 7 5 N o d e 01/ d b 2 a d m i 


E 


Note: You can create a newJ2C authentication alias by aL:e^ing one o 
following links. Clicking on a link will cancel the wizard and y<^^ current 
wizard selections will be lost. 

Global J2C authentication alia a 

Security domains 


Previous""] Next | Cancel 
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Finally we confirm that we have completed the task: 


Create a data source 


Create a data source 


Step 1: Enter basic 
data source 
information 

Step 2: Select JDBC 
provider 

Step 3: Enter 
database specific 
properties for the 
data source 

Step 4: Setup 
security aliases 

Step 5: Summary 


Summary 

Summary of actions: 


Options 

Values 

Scope 

cells :viin7-x€4NodeO 1 Cell : nodes :win7- 
x64NodeO 1 : servers : serverl 

Data source name 

MANUFAC 

JNDI name 

j d be/ MAN U FAC 

Select an existing JDBC provider 

DB2 Universal JDBC Driver Provider (XA) 

Implementation class name 

co m.ibm.db2.jcc.DB2XAData Source 

Driver type 

4 

Database name 

MANUFAC 

Server name 

local host 

Port number 

50000 

Use this data source in 
container managed persistence 
(CMP) 

false 

Authentication alias for XA 
recovery 

viin7-x64Node0l/db2admin 

Component-managed 
authentication alias 

win7-x64Node01/db2admin 

Mapping-configuration alias 

(none) 

Container-managed 
authentication alias 

win7-x64Node0l/db2ad min 


Previous | Finish | 


_j. Click Finish and then make sure you click Save: 


El Messages 

f^i Hi mi) .Ii^Tm made to your local configurator 

* Save^Kectly to the master configuration. 

• Review changes before saving or discarding. 

&-The server may need to be restarted for these char 


k. Log out of the console and close the browser. 

l. Stop and restart the Process Center server. 
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4 Testing the Service in Integration Designer 

Once the Process Center server is back up, we want to run a unit test of our integration service in IID. 

_1. Within Integration Designer, start the test client: 

_a. Open or select the Assembly Diagram for the Order Fulfillment module. Right click 

anywhere in the Assembly Diagram canvas and select Test Module: 


WSImportl 


IDBCImport 


Problems 


<]Ajndo 

t^Redo 

Revert 

M ,Add Note 
Hide Notes 

o^Cut 

Wf0PV 

Paste 

S^Delete 

Select All 

Add... ► 

Merge Components 

Show Transaction Highlighting 
Remove Transaction Highlighting 

(+\Zoom In Ctrl+= 

(“i^Zoom Out Ctrl+- 

■/ “‘^Automatic Layout 

Layout Contents 


Test Module 


CkniM Pi i c r-. 1=. \ Kbrna 
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_b. The test client opens up. On the right-hand side, ensure that the Component is set to 

OrderFulfillment (the interface should read the same). Specify some parameters for 
order number, color, size, and weight: 

^ Detailed Properties 

Specify the component, interface, operation, and input parameter values for the It 
Continue icon in the Events area to run the test. More... 


Configuration: |Default Module Test 


Module: 

Order Managementi , 'Order_Management_Implementation 

Component: 

| OrderFulfillment 


Interface: 



| OrderFulfillment 






Operation: | invoke 


0 Binding type is supported (?) 

Initial request parameters: 

© Value editor O XML editor 




B 

■ 


Name 

J - toe - 



1 • •; •:; 

I B order 

Order 

faEI 


. . 


.££n orderNumber 

int 

110 10 


HI 


.tH widgetColor 

| string_ 

[10 Black 


: 


ffB widgetSize 

int 

[10 2 




St-S 1 .' idaetVv'e aht 1 

double 

;SE 2.2 



1 1 II 


i; 






i 


c. Run the test by clicking on the green arrow on the top left hand side of the test client 
window: 


Detailed Properties sections. More... 






h | #► ” | h ” | b y 

j 1[; " Invoke 




The first time the test client runs, it may need a test server to be defined. The following steps are 
necessary if this is the first time you run a test in I ID. 

2. Define the test server: 
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.a. On the screen that prompts you to select a deployment location, click New Server...: 
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b. On the subsequent screen, pick IBM Process Center v7.5: 
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_c. Click Next. You should be able to leave the default for the location of the Process Center. 
Click Test Connection to make sure you can connect, and then click OK and Next: 


ct* New Server 


Create an IBM Process Center 

Specify the settings to connect to a Process Center. 


Use Default Process Center 




Hostname: | localhost 
HTTP port: | 9080 
User ID: | admin 


Password: | 




Test Connection 


ef* Test Connection 
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d. Leave the defaults on the next screen and then click Finish: 



It may take a few minutes while the server definition is created in the server view. 
_3. Completing the test: 
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.a. Now you should be able to pick the server definition we just created from the Select 
Deployment Location screen: 



b. Click Finish. Specify admin/admin when challenged to log in: 
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c. The test will start running. You will be able to follow the step-by-step execution on the 
test client window: 



Invoke (OrderFulfillment:invoke) 

B % Invoke started 

□ 0 : 2j Bindinq (SCA:OrderFulfillment) 

Invoke (OrderFulfillment: invoke) 

C> Request (OrderFulfillment — > OrderFulfillment_Process:invoke) 

B ^ Fine-Grained Trace (OrderFulfillment_Process:OrderFulfillment_Process) 
Receive (invoke) 

!=□ Prep for DB insert 

Insert into DB (createBpmadminManufac) 
a Prep for Factory Floor 

Invoke Factory Floor (createWorkOrder) 
d Set Result 


Na Reply 


C> Request (OrderFulfillment_Process — > JDBCImport:createBpmadminManufiac) 
0 Response (OrderFulfillment_Process <— JDBCImport: createBpmadminManufac) 
C> Request (OrderFulfillment_Process — > WSImportl:createWorkOrder) 

0 Response (OrderFulfillment <--OrderFulfillment_Process: invoke) 


Return (OrderFulfillment: invoke) 


i!q Binding (SCAiOrderFulfillment) 
U Invoke returned 


d. If the test is successful, you should see no exception in the execution trace, and the 
serviceResponse on the right hand side should show “Order Fulfilled”: 


Efe | 3 


Type 

r 

VA* 

■fc ^erv>rrfi«porsr 


3Eu-rr Rifl 



Now that we have successfully tested our integration service, we can used it from the Process Designer. 


.4. Close the Integration Designer and switch back to the Process Designer. 
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5 Testing the End-to-end Implementation 

Let’s test the end-to-end process in Process Designer. 

_1. Open the Order Management application in the Designer view. 

_2. Open the Order Processing BPD. 

_3. Add a final Notify Customer activity to the process. 


a. Drag a new activity to the Order Approver lane. Wire it to the End node (which could 
also be moved to the same lane). Wire the Order Fulfillment activity to the new activity. 
Rename the new activity Notify Customer: 



b. Right click the newly added activity and click Activity Wizard... 

c. Leave the defaults (human activity) and click Next. 
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d. On the Parameters screen, click on the true definitions to make them false as indicated 
below (we only want the order and serviceResponse to be inputs, and no outputs): 



e. Save your work. 

f. Click Play to run a new instance of the entire process. Complete the first two steps in the 
Inspector view as we did before (approve the order so that we can execute the 
integration service). 
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g. You should see that the Notify Customer activity is reached and a task is created. 
Select and execute the task: 




_h. If everything was successfully executed, you should see “Order Fulfilled” in the Service 

Response text field of the coach. 

This concludes the end-to-end build-from-scratch lab! 
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Appendix A. Set up instructions 

This lab requires a few extra set-up steps that you may need to perform ahead of time. 

_1. Creation of the database and table for the JDBC Adapter. The lab requires a simple DB2 

table to store the order information. We have provided a script that you can run. The script 
assumes you are using bpmadmin as the DB admin (if that’s not the case, edit it and change 
bpmadmin to whatever is your admin user id). 

_a. Open a Windows command prompt. 

_b. Change directories to the \Part2Setup subdirectory under the directory where you can 

find this document. There should be a script called manufac.sql. 

_c. On the command line, issue: 

db2cmd 

_d. Another command prompt opens up. In that command prompt window, issue: 

db2 -tf manufac.sql 

_e. You will be prompted for the password (bpmadminl). The script should successfully 

create a database and a table. 

_f. Close the command prompts. 

_2. Install the web service application. In order to call a web service, you need to have one. To 

eliminate all dependencies from external web services, connectivity issues etc. we have provided 
a very simple application, but you must first install it on the process center. 

_a. Make sure the Process Center server is up and running. 

_b. Open a browser and go to the admin console (http://localhost:9060/admin by default). 

_c. Log in as admin/admin. 

_d. On the left hand side, expand Applications. 

_e. Click New Application. 

_f. Click New Enterprise Application on the main pane. 
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g. Click Browse and navigate to the same \Part2Setup directory. Select 
FactoryFloorApp.ear. 


Specify the EAR r WAR r JAR r or SAR module to i 


Path to the new application 


** Local file syster 
Full path 


|ctop\FactoiyfloofApp.ear Brows&_ 


h. Click Next. Make sure that Fast Path is selected and click Next again. 

i. On the subsequent screen, click on Step 3 - Summary: 


Install New Application 


Specify options for installing ente 

■4 Step 1: Select 

installation options 

Selec 


Step 2 Map 
modules to servers 

Sped 

r f 


Dire 

LI 

W r 


_j. Click Finish. 

_k. The application will install. You should receive a successful completion message: 





Application Factor/FloorApp 

installed successfully. 






To start the application, first save changes to the master configuration. 

Changes havehg^frtfiade to your local configuration. You can: 

• Save flrcctlv to the master configuration. 

• Review changes before saving or discarding. 

_I. Make sure that you save your work. 

_m. You need to start the application. On the navigator pane, expand Application types and 

click WebSphere Enterprise Applications: 

El Applications 

■ N ew Ap plication 
□ Application Types 

■ WebSphere enterprise applic 

■ Business-level applications 
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n. Check the checkbox by FactoryFloorApp and click Start: 



_p. The application should start (the green arrow should now show. Log off the console. 

3. IF and only IF you haven’t done PART 1. 

_a. You need to import the solution of Part 1 into the Process Designer. There is a file with 

the solution in the directory \Part1 Solution - called Order_Management - Part l.twx. 
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